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About This Guide 



This guide contains introductory, procedural, and 
reference information for users of the Editor software 
application. The Editor allows you to enter, edit, copy, 
store, and retrieve textual information on your 
workstation. 

To understand the procedures and information in this 
guide, you must be familiar with the Unisys workstation 
operating system (BTOS) Executive level operations. 

This guide contains three sections, two appendixes, a 
glossary and an index. 

Section 1 provides introductory information and 
installation procedures. 

Section 2 describes the Editor screen and provides 
procedures for basic text entry and edit. 

Section 3 provides procedures for more advanced editing 
operations. This section assumes you are familiar with the 
procedures discussed in sections 1 and 2, 

Reference Material 

This guide contains two appendixes and a glossary with 
reference information: 

D Appendix A lists and explains error and status 
messages. 

D Appendix B is an alphabetical list of Editor command 
functions. 

D The glossary defines Editor terms. 

Conventions 

This guide uses the following conventions: 

D caps Executive and Editor commands; caps and holds 
function keys. 

D hyphenates keys you use in combination; for example, 
CODE-V indicates that you hold down the CODE key 
and then press the letter V. 
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vi Introduction 

Related Material 

For additional information on the BTOS and Executive 
level commands, refer to the BTOS Standard Software 
Operations Guide. 
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Section 1 i-i 

Overview 



The Editor is a software application that allows you to 
enter and edit text using the keyboard of your 
workstation. The text appears on the screen as it would on 
a typewritten page. 



Editor Capabilities 



The Editor text management capabilities include: 

D text development: 

D inserting, overtyping, and deleting text 

D one-step repetition and canceling of the most recent 
editing operation 

n selecting text for copy, delete, or move operations 

D copying/merging among Editor files 

Note: You can copy/merge the files of another application (for 
example, a word processor file) into text you create with the Editor. 
Special text attributes such as holding and underlining, however, are lost 
in the copy process. 

n text search and replacement 

D inserting a byte in hexadecimal code 

D text display: 

a speedy cursor movement 

D line and page text scrolling 

D optional viewing of format codes 

a option of 80- or 132-column display (on workstations 
with the zoom capability) 

D help display of Editor commands 

n text storage and retrieval 

To activate the Editor, you execute the EDIT command 
from the Executive command level, after setting the path, 
if necessary. 
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1-2 Overview 

Accessing the Executive Command Level 

You access the Executive command level from the SignOn 
form that displays after you turn on your system. Use the 
following procedure: 

1 Enter a user name in the User name field if your 
system requires one. 

2 If your system requires a password, press RETURN to 
move the highlight to the Password field and type the 
password. 

The password displays as a series of pound signs (#). 

Note: If your system requires a password and/or user name and you do 
not know them, contact your system administrator. 

3 To change the date or time, press RETURN to move the 
highlight to the Day/Date/Time field and type the time 
and/or date/day. 

4 Press GO. The system replaces the SignOn form with 
the Executive command prompt. 

If an error message appears after you press GO, the cursor 
and highlight appear at the problem field. You must 
reenter the field information and press GO again. 



Setting the Path 



You must set the system path to designate a default 
volume and directory before you activate the Editor. When 
you initiate a command or function, the system acts on the 
default volume and directory. 

To change the system's path, use the following procedure: 

1 At an Executive command prompt, type path and press 
RETURN. 

The system displays the PATH command form. The 
highlight is on the [Volume] field. 

2 To change the default volume, type a volume or device 
name. Do not use square brackets. 
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3 To change the default directory, press RETURN to 
move the highlight to the [Directory] field and type the 
directory name. Do not use angle brackets. 

4 Press GO. The system's path is now to the volume and 
directory you specify. 

For more information on setting the path, refer to the 
BTOS Standard Software Operations Guide. 



Installing the Editor 



You can install the Editor when you install the operating 
system on your workstation. During BTOS installation, you 
respond to the system's displayed query about installing 
the Editor (refer to the BTOS Standard Software 
Operations Guide). 

However, when BTOS is installed on your workstation and 
the Editor is not, you can install the Editor from the last 
installation diskette of the BTOS series of installation 
diskettes. The diskette is write-protected; you should not 
write-enable it or use it as a working copy. 

To install the Editor on a hard disk system, use the 
following procedure: 

1 Sign on to your workstation and set your path for the 
system directory. 

2 If the system is clustered, disable the cluster (use the 
Executive DISABLE CLUSTER command) or power 
down the other cluster units. 

3 Insert the last BTOS software installation diskette in 
the floppy drive. 

4 Type Submit at an Executive level command prompt, 
then press RETURN. The following Submit form 
appears with the highlight in the File list field: 

Submit 
File list 
[Parameters] 
[Force expansion?] 
[Show expansion?] 
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1-4 Overview 

5 Enter the file name [fO]<Sys>Editor.sub and press 
RETURN. The highlight moves to the [Parameters] field. 

6 Enter [Sys] <Sys>Sys.Cmds [Sys]<Sys>; then press GO. 

The system installs the Editor in the [Sys] <Sys> 
directory, and creates the EDIT command in the 
[Sys]<Sys>Sys.Cmds command file. 

Note: If you do not enter the two parameters, the system installs the 
Editor in your current pathed directory. 

When the system finishes software installation, the 
Executive command prompt appears. 

7 Remove the diskette. If your workstation is clustered, 
you can resume cluster operations (use the RESUME 
CLUSTER command). 

The EDIT command is now available at the Executive 
level; you can use the command to enter and edit text. 

Installing the Editor From the XE520 

To install the Editor from the XE520 mainframe computer, 
use the following procedure: 

1 Power down all other cluster workstations of the 
XE520. 

2 Sign on with the user name ADMIN. 

3 Insert the last BTOS software installation diskette in 
the floppy drive. 

4 Type Submit at the command line, then press 
RETURN. The following Submit form appears: 

SUBMIT 

File List 
[Parameters] 
[Force expansion?] 
[Show expansion?] 
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5 Enter the file name [fO]<Sys>Editor.sub and press 
RETURN. The highlight moves to the [Parameters] field. 

6 Enter [Sys]<Sys>Sys.Cmds [Sys]<Sys>; then press GO. 

The system installs the Editor in the [Sys]<Sys> 
directory, and creates the EDIT command in the 
[Sys]<Sys>Sys.Cmds command file. 

Note: If you do not enter the two parameters, the system installs the 
Editor in your current pathed directory. 

7 Remove the diskette. You can resume cluster operations. 

The EDIT command is now available at the Executive 
level; you can use the command to enter and edit text. 
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Section 2 2^ 

The Editor Session 



You begin an Editor session by accessing the Executive 
command level (refer to section 1), and then executing the 
EDIT command. 

The Editor screen appears. The Editor screen displays text 
as you enter and edit it. 

When you end an Editor session, the system files your 
work if you want it to, and returns to the Executive 
command level. 

Specifying Editor File Names 

When you execute the EDIT command, you must identify a 
text file by name in the Edit form. You can also identify a 
prefix for the typescript (.ts) file for the session. The Edit 
form has two fields: 

Edit 

File 

[Your name] 

The File field specifies the file name for the text you 
create or edit in the Editor session. The system uses this 
file name to store, retrieve, write, and read the text you 
enter under it. 

The [Your name] field specifies a prefix for the typescript 
(.ts) file of the Editor session. The default is xxxx.ts, 
where xxxx is the logged-on user name; if there is no 
logged-on user and you leave this field blank, the default 
is .ts 

The system uses this file to recover the text with the 
REPLAY command (refer to Replaying an Editor Session). 

Editor file names should conform to the file name 
parameters for all files. Refer to the BTOS Standard 
Software Operations Guide for further information. Refer 
also to Storing Editor Files. 

Note: Ail alphanumeric keys and the DELETE function key have repeat action 
when you hold them down. 
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2-2 The Editor Session 

Beginning an Editor Session 

The Executive command, EDIT, accesses the Editor screen 
and gives keyboard control to Editor operations. To 
execute the EDIT command, you use the following 
procedure: 

1 Enter the word EDIT in the Executive command field 
and press RETURN. The following Edit form appears 
with the highlight in the File field: 

Edit 

File 

[Your name] 

2 Enter the name of the file you want to edit or create; 
then press RETURN. The highlight moves to the [Your 
name] field. 

3 To specify a prefix for the typescript (.ts) file 
associated with the file you create or edit, enter a name. 

To accept the default typescript file name, leave this 
field blank. 

The default is xxxx.ts, where xxxx is the logged-on user 
name; if there is no logged-on user and you leave this 
field blank, the default is .ts. 

4 To execute the EDIT command, press GO. If you specify 
a name for which no file exists, the following message 
appears: 

File filename does not exist. Press GO to create or 
CANCEL to deny. 

To create the file, press GO. 

To change the file name, press CANCEL, press Fl to 
edit the name, and then press GO. 

The Editor screen appears, displaying the file you 
specify (refer to The Editor Screen). 

To cancel the EDIT command, press CANCEL before you 
press GO. 
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Replaying an Editor Session 

The REPLAY command also activates the Editor. You can 
use the REPLAY command to replay (reenter) the previous 
session whenever a replay is useful; for example, when: 

D the Editor terminates abnormally (a power failure or a 
disk full condition) 

D you want to duplicate entries made in one file into 
several other files 

After the replay, you resume the Editor session. 

The REPLAY command replays the previous session from 
the typescript (.ts) file: a file the system creates during 
each Editor session. 



The Replay Procedure 

To recover your work when the Editor terminates 
abnormally, use the following procedure: 

1 Remedy the cause of the abnormal termination, if 
necessary. For example, if the system displayed a Disk 
full message, you should delete unnecessary files to 
make additional space on the disk. 

2 Copy the Editor session file and its typescript file with 
the Executive COPY command. 

3 Enter the word REPLAY in the Executive command field . 

4 Press RETURN. The following Replay form appears, 
with the highlight in the File field: 

Replay 
File 
[Your name] 

5 Enter the file name (the same file name or a new file 
name on which to save the replay session) and press 
RETURN. The highlight moves to the [Your name] field. 

6 If you specified a typescript file prefix for the session 
you are replaying, enter that prefix. If not, leave the 
field blank. 

7 Press GO. The Editor screen appears displaying the 
replay of the previous Editor session. 
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2-4 The Editor Session 

8 To suspend the replay, press CANCEL before you press 
GO. The system displays the message Replay 
suspended. To resume the replay after suspending it, 
press GO. 

To stop replay and resume editing, press CANCEL 
twice. The remainder of the replay session is lost. 

The Editor Screen 

The Editor screen appears after you execute the EDIT 
command and fills the physical screen, dividing it into 
three parts by a double highlighted line (refer to 
figure 2-1): 

a the status frame the top screen line where the 

Editor version number, 
cursor file position, and 
Editor messages display 

D the message frame the second line where the 

name of the file being edited 
appears (not available on 
B 21 and B 22 workstations) 

a the text frame the remainder of the screen 

where text displays as you 
enter and edit it 



The Editor screen also contains: 

D a cursor that marks the point of your next text entry or 
operation 

D an end-of-file symbol (a hollow square) that marks the 
end of the displayed file 

When you activate Editor commands that have forms and 
require input, and when you display Editor commands, the 
system overlays the bottom lines of the text frame with a 
command area (refer to figure 2-1). The command area 
temporarily hides your text, if any. 

To display the Editor screen, refer to Beginning an Editor 
Session. 



The Editor Session 
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Figure 2-1 Sample Editor Screen 
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The Editor Session 



Entering Text 



Using the keyboard's alphanumeric keys and Spacebar, 
you can enter text in two modes: 



D insert mode 



D overtype mode 



the OVERTYPE keytop light 
is out; within existing text, 
characters you enter move 
existing characters to the 
right 

the OVERTYPE keytop light 
is on; within existing text, 
characters you enter replace 
characters 



When necessary, the text in a line automatically wraps to 
the next line. 



Deleting Text 



You can delete text with two keys and one key 
combination (characters to the right of and below deleted 
text move to fill the space of deleted text): 



D DELETE 



o BACKSPACE 



D CODE-DELETE or 
FIO 



deletes the character above 
the cursor; deleting the last 
character on one line pulls 
up the characters from the 
following line 

deletes the character to the 
left of the cursor when the 
system is in insert mode 
(moves the cursor to the left 
without deleting in overtype 
mode) 

backspacing at the left edge 
of the text frame wraps to 
the last character of the 
preceding line 

deletes selected text (refer to 
Selecting Text, in section 3) 
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Moving the Cursor 



The cursor is a blinking underline that marks the point of 
your next text entry or edit operation. 

The cursor moves as you enter and delete text and 
perform other editing operations. In addition, you can 
move the cursor with the direction keys and some key 
combinations (refer to table 2-1). 

You can move the cursor to a space below the end of the 
file to enter text or perform an edit operation. When you 
do this, the system: 

D inserts line feeds for every line between the cursor and 
the end of previous text 

n fills the line the cursor is on with spaces, if necessary 

D moves the end-of-file symbol to the new end of the text 

When you move the cursor beyond the right or left frame 
margins, it wraps to the opposite side on the same line. 
Similarly, when you move the cursor beyond the top or 
bottom screen lines, it reappears at the opposite end of the 
screen in the same column. 



Displaying Text 



The Editor provides you with several options for text 
display (refer to table 2-2). They include: 

D scrolling by line, line group, and page 

o viewing formatting characters and the Editor command 
list 

a accessing text at a specific percentage position relative 
to total text length 

D adjusting text frame width 
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The Editor Session 


Table 2-1 


Keys that Move the Cursor 




Key 


Moves the Cursor 





Right Arrow 
Left Arrow 
Up Arrow 
Down Arrow 
SHIR-Right Arrow 
SHIFT-Left Arrow 
SHIFT-Up Arrow 
SHIFT-Down Arrow 
TAB 

COOE-Right Arrow 
CODE-Left Arrow 
COOE-Up Arrow 
COOE-Down Arrow 



right one character 

left one character 

up one line 

down one line 

five characters to the right 

five characters to the left 

up three lines 

down three lines 

eight characters to the right 

to the right end of text line 

to left edge of line 

to top line of frame 

to bottom line of frame 



Table 2-2 Keys for Displaying Editor Text 



Keys 



Action 



SCROLL UP 
SCROLL DOWN 
SHIFT-SCROLL UP 
SHIFT-SCROLL DOWN 
CODE-N 

NEXT PAGE 
PREV PAGE 



scrolls text up one line 

scrolls text down one line 

scrolls text up ten lines 

scrolls text down ten lines 

the NORMALIZE command: moves text so that the cursor 
is halfway between the bottom and top of text frame (text 
can be selected or not) 

displays next page (bottom two screen lines become top 
two screen lines) 

displays previous page (top two screen lines become 
bottom two screen lines) 



The Editor Session 
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Table 2-2 Keys for Displaying Editor Text (continued) 


Keys Action 



CODE-n (0-9) displays text at a specific percentage of text's length 

according to the formula n * 11%; for example, 

COOE-0 = 0% (start of file) 
CODE-9 = 99% (end of file) 
CODE-5 = 55% (middle of file) 

CODE-J the JUMP command: moves text so that the cursor is at a 

specific percentage of the text's total length (refer to The 
JUMP Command Procedure) 

CODE-V the VISIBLE command: alternates between displaying and 

not displaying formatting characters (line feeds, tabs, and 
spaces) 

HELP the HELP command: displays the Editor command list 

(press CANCEL to dismiss) 

CODE-Z the ZOOM command: alternates between text frame widths 

of 80 and 132 columns (only on workstations with the 
zoom capability) 



The JUMP Command Procedure 

With the JUMP command, you can move text so that the 
cursor is within a specific percentage of the text's total 
length. You use the following procedure: 

1 Press CODE-J. The following JUMP command form 
appears in the command area with the cursor in the . 
Percent: field: 

Jump 

Percent: <> 

2 Enter a number from through 99 that represents the 
percentage position in relation to the file's total length 
(for example, 50 would specify the middle of the text file). 

3 Press GO. The JUMP command form disappears, and the 
system displays the cursor at the text position you specify. 

To cancel the command, press CANCEL before you press GO. 
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2-10 The Editor Session 

Repeating Edits 

You can repeat entries and command operations 
immediately after you finish them by pressing the REDO 
key, Fl. For example, you press REDO to find successive 
occurrences of the same text with the FIND command (see 
section 3). 

The system treats the CODE-DELETE (or FIO) operation 
and subsequent insertion of text as a unit for the REDO 
command. 

Canceling Edits 

By pressing CANCEL, you can cancel entries and 
command operations immediately after you finish them. 
For example, you press CANCEL to restore text you 
delete (the system treats the CODE-DELETE (or FIO) 
operation and subsequent insertion of text as a unit in a 
selected text deletion). 

Closing an Editor Session 

You close an Editor session with the FINISH command, 
using the following procedure: 

1 Press the FINISH key. The following Finish form 
appears in the command area with the cursor in the 
Save?: field: 

Finish 
Save?: <> 

2 To save (file) the session's entries, choose one of the 
following: 

D Type y for yes (the default). 

D To exit the Editor without saving the session's 
entries, type n for no. 

3 Press GO to exit the Editor. The Executive command 
prompt replaces the Editor screen, and the system files 
your entries if you instruct it to. 

To cancel the command, press CANCEL before you press GO. 
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Terminating the Editor Abnormally 

If you do not use the FINISH command to terminate the 
Editor, an abnormal termination occurs. ACTION-FINISH 
causes an abnormal termination. The Executive command 
line replaces the Editor screen, and the system displays an 
appropriate message. 

To recover entries when an Editor session terminates 
abnormally, use the REPLAY command (refer to Replaying 
an Editor Session). 

Storing Editor Files 

When you respond yes to the Save option in the FINISH 
command, the system saves your entries on a disk file 
with the file name you specified in the EDIT command 
form at the beginning of the session. (It also saves a 
typescript (.ts) file of the session; refer to Specifying 
Editor File Names.) 

If a disk file of the same name exists, the system 
automatically appends -Old to it. You can access the -Old 
file by specifying the file name with the suffix in the 
EDIT command form. The system retains only the most 
recent previous version of any file. 

Refer to the BTOS Standard Software Operations Guide 
for further file information. 
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Advanced Editing Operations 

The Editor application provides editing operations that 
allow you to make major changes in text efficiently. These 
operations include: 

D selecting text 

D searching for text strings 

D searching for and replacing text 

n copying disk file text to Editor screen text and vice versa 

D inserting hexadecimal values 



Selecting Text for Editing 



The Editor allows you to select any amount of continuous 
text. The system treats the selection as a unit for editing 
operations, such as move, copy, or delete. The system 
highlights text you select. 

Table 3-1 shows the types of selection available and how 
to make them. 

Table 3-1 Types of Text Selection 



Selection 






Type 


Key 


Character Selection 


Mark 


MARK 


from cursor to end of line 


Word Mark 


MARK-Up Arrow 


word containing the cursor and the space 
following it 


Line Mark 


MARK-Right Arrow 


line containing the cursor 


Entire File 


COOE-E 

(EVERYTHING 

command) 


entire file in memory 
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Changing a Selection 

You can reduce or expand a text selection after you make 
it by using the following procedure: 

1 Move the cursor to the position where you want the 
selection to start. 

2 Press MARK. 

3 Move the cursor to the position where you want the 
selection to end. 

4 Press BOUND. Selection adjustment depends on your 
original selection type: 

D mark selection stops at the cursor 

position 

o word mark selection includes the word 
containing the cursor 

D line mark selection includes the line 
containing the cursor 

n entire file selection stops at the cursor 
position 



Canceling a Selection 

To cancel a selection after you make it, use the following 
procedure: 

1 Move the cursor into the highlighted selection. 

2 Press MARK-BOUND. The highlight disappears except 
for the character above the cursor. 

3 To eliminate the cursor character highlight, press 
OVERTYPE or DELETE, and then retype the 
character. 
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Deleting a Text Selection 



To delete a text selection, use the following procedure: 

1 Select the text. 

2 Press CODE-DELETE, or FIO. The highlighted text 
disappears. 

You can retrieve deleted text by pressing CANCEL 
immediately after deleting the text. 

Moving and Copying a Text Selection 

You can move and copy text by making a selection first 
and then specifying the location of the moved or copied 
text; or you can specify the new text location before you 
select the text. 

To move and copy text by making the text selection first, 
use the following procedure: 

1 Select the text to move or copy. 

2 Move the cursor to the beginning of the new text location. 

3 Press MOVE or COPY. The system moves or copies text 
to the location you specify. 

To move and copy text by specifying the new location 
before making a selection, use the following procedure: 

1 Move the cursor to the new text location. 

2 Press the MOVE or COPY key, but do not release it. 

3 Select the text to move or copy. 

4 Release the MOVE or COPY key. The system moves or 
copies text to the location you specify. 
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3-4 Advanced Editing Operations 



Searching for Text 



You execute the FIND command to search the file for a 
specific text string. The search starts at the cursor 
position, and the system matches text without regard for 
upper- and lowercase. You use the following procedure: 

1 Position the cursor where you want the search to start. 

2 Press CODE-F. The following Find form appears in the 
command area with the cursor in the String: field: 

Find 

String: <> 

3 Enter the text string for the search. 

4 To execute the command, press GO. The Find form 
disappears, and the system highlights the first 
occurrence of the text string, if any. 

To cancel the command, press CANCEL before you press GO. 

5 To continue the search, press the REDO key (Fl). The 
system highlights the next text string occurrence. 

To alter the text string, enter editing changes. To 
resume the search after you edit, repeat steps 2 and 4. 

To remove the last highlight from the search string, use 
the procedure under Canceling a Selection. 

Searching and Replacing Text 

The SUBSTITUTE command allows you to search for a 
specific text string and replace it with another text string. 
The system matches text without regard for upper- and 
lowercase. You use the following procedure: 

1 Select the text for the substitute operation. 

2 Press CODE-S. The following Substitute form appears 
in the command area with the cursor in the New: field: 

Substitute 
New: <> 
Old: <> 
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3 Enter the text you want to replace existing text; then 
press NEXT. The cursor moves to the Old; field. 

4 Enter the text you want to replace. 

5 To execute the command, press GO. The Substitute form 
disappears, and the system searches for and replaces 
the text you specify. 

To cancel the command, press CANCEL before you press GO. 

Copying From a Disk File to the File in Memory 

The READ command allows you to copy characters from a 
disk file into the file in memory, that is, the Editor screen. 
You can select individual characters, portions of text, or 
the file's entire contents. Note, however, that special text 
attributes (such as holding or underlining) are lost in the 
copy process. 

Caution: When you execute the READ command, the system opens the disk 
file and sets up a pointer to the text you specify to be copied. Therefore: 

a If the file is on a floppy disk, you must finish the Editor session before you 
remove the disk. 

D Because the file remains open until you end the Editor session, you cannot 
write to it with the WRITE command in this session. 



You use the following procedure: 

1 Position the cursor where the copied text is to begin. 

2 Press CODE-R. The following READ command form 
appears in the command area with the cursor in the 
File: field: 

Read 
File: <> 

Number of Characters: <> 
Position: <> 

3 Enter the name of the file from which you want to copy 
text. 
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4 Press NEXT. The cursor moves to the Number of 
Characters: field. 

5 Choose one of the following: 

D To copy the entire file, go to step 6. 

D To copy all text from the starting position (specified 
in step 6), leave this field blank. 

D To specify the number of characters to copy, enter a 
number; then press NEXT. The cursor moves to th^ 
Position: field. 

The system nimibers file characters from (the first file 
character); you must manually count the number of 
characters you want to copy. 

6 Choose one of the following: 

D To start text copy from the beginning of the file, 
leave this field blank. 

D To specify the character you want to start copied 
text with, enter a number. 

You must manually count the number of characters 
from the first file character (0), and enter the number 
of the starting character. 

7 To execute the command, press GO. The READ 
command form disappears, and the system copies the 
text you specify, highlighted, into the file on the Editor 
screen. 

To remove the highlight from the selection, follow the 
procedure under Canceling a Selection. 

To cancel the command, press CANCEL before you press GO. 

Copying From a File in Memory to a Disk File 

The WRITE command allows you to copy selected text 
from the Editor screen to a disk file. You use the following 
procedure: 

1 Select the text you want to copy (refer to Selecting Text 
for Editing). 

2 Press CODE-W. The following WRITE command form 
appears in the command area with the cursor in the 
File: field: 

Write 
Pile: <> 
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3 Enter the name of the file you want to copy text to. 

4 To execute the command, press GO. The WRITE 
command form disappears, and the system copies the 
selected text to the disk file you specify. 

To cancel the command, press CANCEL before you press GO. 

Inserting Hexadecimal Values 

The INSERT command allows you to insert a byte whose 
code is a specified hexadecimal value. For example, to 
insert a division sign (^) into the text, you insert the 
hexadecimal value of 15. You use the following procedure: 

1 Position the cursor at the location for the insertion. 

2 Press CODE-I. The following Insert form appears in the 
command area with the cursor in the Code: field. 

Insert 
Code: <> 

3 Insert the hexadecimal value for the byte. 

4 To execute the command, press GO. The system inserts 
the character defined by the hexadecimal code you specify. 

To cancel the command, press CANCEL before you press GO. 
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Appendix A 

Status and Error Messages 



A-l 



Editor status and error messages that display in the message 
frame assist you with Editor operations. Table A-l lists mes- 
sages and provides additional information to help you solve a 
problem. 

Table A-1 Status and Error Messages 



Message 



Explanation/Action 



Bad length 



Bad position 



Cannot edit there 
Cannot select there 



Cannot open file 



Cannot put 



Cannot write on that 
file 



Choose a frame 
Disk full, please finish 
Illegal action 



In the READ command form, the specified number of char- 
acters, plus the position, exceeds file length. Verify the pa- 
rameter information, and reactivate the command. 

The position specified in the READ command form is be- 
yond the end of the file. Verify the starting character posi- 
tion, and reactivate the command. 

You attempted to edit outside the text 
frame and command form. Move the cursor to an accepta- 
ble editing location. 

You cannot open the specified file for reading or writing. 
Either the file is already open or it does not exist. Verify 
the file's status (you cannot simultaneously read and write 
a file). 

The file you are editing and its old version are already 
open. Write the entire file to a new file name, selecting it 
with the EVERYTHING command first; then rename it. 

You cannot write in the file specified in the WRITE com- 
mand form. The file may be write-protected or the disk 
may be full. Specify a different file or clear some disk space. 

You pressed a key (such as SCROLL UP or NEXT PAGE) 
that requires the cursor to be in the text frame. Move the 
cursor to the text frame. 

Disk storage space is low. Save your file immediately. If 
you cannot save, create disk space by deleting unneeded 
files, then replay the session with the REPLAY command. 

You pressed one or more keys that cannot operate at this 
point in your session. 
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Status and Error Messages 


Table A-1 


Status and Error Messages 


(continued) 


Message 


Explanation/Action 





Memory low, please 
finish 



Next not legal 

No form 

No such command 

Not found 



Nothing selected 

Nothing to write 

Replay complete 
Replay suspended 



Memory storage is low. You can free memory by saving 
the file and reentering the Editor. 

A large text selection during the Substitute operation can 
cause this message. Substitute a sequence of smaller 
selections. 

You pressed NEXT when the cursor was not in a form field. 

You pressed GO without completing a command form. 

You pressed one or more keys that cannot operate at this 
point in your session. 

The system could not find the text specified in the Find 
form. Either the text does not exist or it is located prior to 
the cursor's position when you executed the FIND 
command. 

You specified a command (such as MOVE or COPY) that 
requires a text selection, and no selection exists. Select 
text and repeat the command. 

The WRITE command has nothing to write. Select text and 
repeat the command. 

Replay is finished; you can resume Editor operations. 

You pressed CANCEL during a Replay operation. Press GO 
to continue the Replay operation, or press CANCEL again 
to stop it and resume normal editing. When you begin nor- 
mal editing, the remainder of the Replay operation, if any, 
is lost. 
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Editor Command List 



Table B-1 lists and explains Editor commands 
alphabetically. 

Table B-1 Editor Commands 



Command 


Key 


Action 


CANCEL 


CANCEL 


reverses the most recent entry or edit 
operation 


EVERYTHING 


CODE-E 


selects entire file in memory 


FIND 


CODE-F 


searches for a text string 


FINISH 


FINISH 


ends an Editor session 


HELP 


HELP 


displays an Editor command list 


INSERT 


CODE-I 


enables insertion of a hexadecimal value 


JUMP 


CODE-J 


moves text so that the cursor is at a 



NORMALIZE 



READ 



CODE-N 



CODE-R 



specific percentage of the text's total length 

moves text so that cursor is halfway 
between bottom and top of text frame 

copies characters from a disk file to a file 
in memory 



REDO 


fl 


repeats the most recent entry or edit operation 


SUBSTITUTE 


CODE-S 


searches for a text string and replaces it 
with another text string 


VISIBLE 


CODE-V 


alternates between displaying and not 
displaying formatting characters 


WRITE 


CODE-R 


appends selected text from a file in memory 
to a disk file 



ZOOM 



CODE-Z 



alternates between text frame widths of 80 
and 132 columns (only on workstations 
with the zoom capability) 
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Glossary 

BTOS. BTOS is the Unisys workstation operating system. 

Command Area. The command area is the last few lines of the Editor screen 
that displays the command list when you activate the HELP command, and 
where command forms appear. The command area temporarily obscures text at 
the bottom of the screen. 

Cursor. The cursor is a blinking underline that marks the point of your next 
keyboard text entry or operation. 

Editor. The Editor is a software application that allows you to enter and edit 
text using the workstation keyboard. 

Editor Screen. The Editor screen is the display area of the Editor application. 
It consists of the status frame and the text frame. 

End-of-file Symbol. The end-of-file symbol is a hollow square that marks the 
end of text in memory on the Editor screen. 

File Name. A file name is the text string that identifies documents that you 
create and store on your workstation's disk. 

Hexadecimal. Hexadecimal refers to a base 16 number system that employs 
two alphanumeric characters to identify numbers, letters, and other characters to 
the operating system. 

Insert Mode. When the system is in insert mode, it automatically moves 
existing characters and spaces to the right to make room for inserted characters 
and spaces. The system is in insert mode if the red light on the OVERTYPE 
key is not lit. The system is normally in insert mode when you first turn it on. 

Keyboard. For text entry, the keyboard includes all the keys found on a 
standard typewriter. In addition, the keyboard has many function keys for 
performing word processing operations. 

Message Frame. The Message Frame is the second line of the Editor screen 
where the name of the file being edited appears (not available on B 21 and 
B 22 workstations). 

Overtype Mode. When the system is in overtype mode, it automatically 
replaces existing characters and spaces with other characters and spaces as you 
enter them. The system is in overtype mode when the red light on the 
OVERTYPE key is lit. 

Path. The path identifies the volume and directory upon which the system 
acts. You identify it with the Executive PATH command, entering the volume 
name in square brackets and the directory name in angle brackets. 
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Status Frame. The status frame is the top line of the Editor screen that 
displays the Editor version number, cursor file position, and Editor messages. 

Text Frame. The text frame is the major portion of the Editor screen where 
you enter and edit text. 

Typescript File. A typescript file (.ts) is a file created by the Editor. It 
contains the typescript for an Editor session, and is the file that the REPLAY 
command uses to replay the session. 



lndex-1 

INDEX 

A 

Abnormal termination of the Editor, 2-1 1 
Accessing the Executive command level, 1-2 
Advanced Editing operations, 3-1 

B 

BACKSPACE key, 2-6 
Beginning an Editor session, 2-2 
BTOS, Glossary-1 
BTOS SignOn form, 1-2 



CANCEL command, 2-9, B-1 
Canceling 

a selection, 3-2 

edits, 2-10 
Capabilities, 1-1 
Changing 

a selection, 3-2 

the path, 1-2 
Closing an Editor session, 2-10 
CODE-DELETE keys, 2-6 
CODE-Down Arrow keys, 2-8 
CODE-J keys, 2-9 
CODE-Left Arrow keys, 2-8 
CODE-Nkeys, 2-8 
CODE-n (0-9) keys, 2-9 
CODE-Right Arrow keys, 2-8 
CODE-Up Arrow keys, 2-8 
CODE-Vkeys, 2-9 
CODE-Z keys, 2-9 
Command area, 2-4, Glossary-1 
Command list, B-1 
Copying 

a text selection, 3-3 

from a disk file to the file in memory, 3-5 

from a file in memory to a disk file, 3-6 
Cursor, 2-4, Glossary-1 

keys that move the, 2-8 

moving the, 2-7 

D 

DELETE key, 2-6 
Deleting 

a text selection, 3-3 

text, 2-6 
Displaying text, 2-7 
Down Arrow key, 2-8 
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EDIT command, 1-4, 2-1, 2-4 
Editing 

selecting text for, 3-1 
Editing operations 

advanced, 3-1 
Editor, Glossary- 1 

abnormal termination of the, 2-1 1 

command list, B-1 

file names, 2-1 

form, 2-1 

installing the, 1-3 

screen, 2-4, Glossary-1 
Editor files 

storing, 2-1 1 
Editor session 

beginning an, 2-2 

closing an, 2-10 

replaying an, 2-3 
Edits 

canceling, 2-10 

repeating, 2-10 
End-of-file symbol, 2-4, Glossary-1 
Entering text, 2-6 
Error messages, A-1 
EVERYTHING command, 3-1. B-1 
Executive command level 

accessing the, 1-2 

F 

File name(s), Glossary-1 

specifying Editor, 2-1 
FIND command, 3-4, B-1 
FINISH command, 2-10, B-1 

H 

HELP command, B-1 

HELP key, 2-9 

Hexadecimal values, Glossary-1 

inserting, 3-7 

I 

INSERT command, 3-7, B-1 
inserting hexadecimal values, 3-7 
Insert mode, 2-6, Glossary-1 
Installing the Editor, 1-3 

from the XE520, 1-4 

J 

JUMP command, 2-9, B-1 
JUMP command procedure, 2-9 
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Keyboard, Glossary-1 
Keys 

for displaying Editor text, 2-8 
that move the cursor, 2-8 

L 

Left Arrow key, 2-8 

M 

MARK key, 3-1 
MARK-Right Arrow keys. 3-1 
MARK-Up Arrow keys, 3-1 
Message frame, 2-4, Glossary-1 
Modes 

insert, 2-6 

overtype, 2-6 
Moving 

a text selection, 3-3 

the cursor, 2-7 

N 

NEXT PAGE key. 2-8 
NORMALIZE command, 2-8. B-1 



Operations 

advanced Editing, 3-1 
Overtype mode, 2-6, Glossary-1 
Overview, 1-1 



Path. Glossary-1 

changing the, 1-2 
setting the, 1-2 
PREV PAGE key. 2-8 

R 

READ command. 3-5, B-1 

REDO command, B-1 

REDO key. 2-10 

Repeating edits, 2-10 

REPLAY command, 2-1. 2-3 

Replaying an Editor session. 2-3 

Replay procedure. 2-3 

Right Arrow key, 2-8 

S 

Screen (Editor). 2-4 
SCROLL DOWN key. 2-8 
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SCROLL UP key, 2-8 
Searching 

and replacing text, 3-4 

for text, 3-4 
Selecting text for editing, 3-1 
Selection 

canceling a, 3-2 

changing a, 3-2 

types, 3-1,3-2 
Setting the path, 1-2 
SHiFT-Down Arrow keys, 2-8 
SHIFT-Left Arrow keys, 2-8 
SHIFT-Right Arrow keys, 2-8 
SHIFT-SCROLL DOWN keys, 2-8 
SHIFT-SCROLL UP keys, 2-8 
SHIFT-Up Arrow keys, 2-8 
SignOn form, 1-2 
Specifying Editor file names, 2-1 
Starting an Editor session, 2-2 
Status frame, 2-4, Glossary-2 
Status messages, A-1 
Storing Editor files, 2-1 1 
SUBMIT command, 1-3, 1-4 
SUBSTITUTE command, 3-4, B-1 



TAB key, 2-8 

Terminating the Editor abnormally, 2-1 1 

Text 

entering, 2-6 

deleting, 2-6 

displaying, 2-7 

frame, 2-4, Glossary-2 

searching and replacing, 3-4 

searching for, 3-4 
Text selection 

copying a, 3-3 

deleting a, 3-3 

moving a, 3-3 
Typescript (.ts) file, 2-1, Glossary-2 
Types of text selection, 3-1, 3-2 

U 

Up Arrow key, 2-8 

V 

VISIBLE command, 2-9, B-1 
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W 

WRITE command, 3-5, 3-6, B-1 

X 

XE520 

installing the Editor from the, 1-4 

Z 

ZOOM command, 2-9, B-1 
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